home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / pm-utils / README < prev    next >
Text File  |  2008-09-06  |  2KB  |  54 lines
  1. === pm-utils ===
  2.  
  3. What is pm-utils?
  4.  
  5. * Pm-utils provides simple shell command line tools to suspend and
  6.   hibernate computer that can be used to run vendor, distribution, or
  7.   user supplied scripts on suspend and resume.
  8.  
  9. Why do we need it?
  10.  
  11. * All the main distributions  are re-implementing the same
  12.   functionality to support common power management
  13.   operations. pm-utils provides a standardized distribution agnostic
  14.   layout and interface for common power management tasks, which frees
  15.   software and hardware vendors from having to maintain
  16.   distribution-specific suspend/resume functionality.
  17.  
  18. * Suspend/resume functionality can be easily modified by installing
  19.   files into the /etc/pm/sleep.d directory.  These files, known as
  20.   hooks, can perform specific tasks on suspend/resume, such as:
  21.    
  22.    - enabling and disabling standby LED's on laptop hardware 
  23.    - enabling suspend GUI's like suspend2 
  24.    - re-enabling video
  25.    - starting and stopping services that can't cope with suspending 
  26.    - re-syncing the time with ntp 
  27.    - removing and modprobing modules when needed 
  28.    - setting grub to be the default target for a hibernate-resume 
  29.    - other wacky things that need doing on specific systems
  30.  
  31. How do hooks work?
  32.  
  33. * You put an executable file in /etc/pm/sleep.d.  When suspend or
  34.   hibernate is called, several things happen:
  35.   
  36.   1) The files in /etc/pm/config.d/* are evaluated in C sort order.  
  37.      These files can be provided by individual packages outside of
  38.      pm-utils, and contain globally available configuration settings
  39.      for pm-utils and the hooks.
  40.   2) Each of the hooks in /etc/pm/sleep.d/* are executed in C sort
  41.      order, with a command line argument of either "suspend" or "hibernate". 
  42.   3) The system suspends or hibernates.
  43.   4) Some event happens to wake the machine up
  44.   5) Each of /etc/pm/sleep.d/* are executed in reverse C sort order,
  45.      with a command line argument of "resume" or "thaw".
  46.  
  47. * For more detailed information on how hooks work and how to write one,
  48.   read HOWTO.hooks .
  49.  
  50. * For information on how to debug pm-utils, read README.debugging.
  51.  
  52.   That's it!
  53.  
  54.